FULL SCREEN 
TEXT EDITOR 


dela 

















Tene 





DATAMAC FULL SCREEN TEXT EDITOR 
OPERATING INSTRUCTIONS 


DATAMAC COMPUTER SYSTEMS 
680 ALMANOR AVENUE 


SUNNYVALE, CA. 94086 








TABLE OF CONTENTS 


SECTION TITLE PAGE 
1.0 INTRODUCTION...... 4: he Geel Aas oe Lw er S Sie awa 2 
2.0 COMMAND DEFINITIONS... ccc ceeeees sl eae ee 
3.0 LOADING THE EDITOR... eee ee eee eee eens 12 
4.0 TEXT EDITING MODE... cee eee eee we eee eo 





ee : ORE Ete TERME RD DEO. oy Ct cob oo Baa eect Oe DPSS a EERE Aa le ego ne EL ahah 





DATAMAC 
FULL SCREEN TEXT EDITOR 
OPERATING INSTRUCTIONS 


1.0 INTRODUCTION 


A comprehensive and complete full screen text editor is an 
option that can be purchased with each DATAMAC computer and _ has 
been designed so that the user will feel at ease with its 
operation. | 


The user should not confuse the DATAMAC editor with a Word 
Processing program even though they are similar. With the editor, 
the user can begin to experiment with entering data and printing 
out messages either on the display screen or a hardcopy printer. 


This editor recognizes two (2) types of files -- program files 
and document files. A program file is utilzed basically by 
programmers to create assembly and library files and the document 
file is used to write letters, memos, data files, etc.. The 
determination of these files, by the editor, is by the use of the 
three (3) character extension (i.e. FILENAME.ASM, with <Assembly> 
being the extension). The editor recognizes the three character 
extension for determining the three types of program files which 
are ASM, LIB and A86. All other extensions will be classified as 
document file extensions. Both of these types of files can be 
reclassified or re-named as the opposite type file by changing 
the extension name. 


2.0 COMMAND DEFINITIONS 


Prior to using the text editor, the user should become familiar 
with the commands and their use. 


NOTE TO THE FIRST-TIME USER 
The phrase TEXT WINDOW will appear thourghout’ the following 
text; therefore, the following explaination is given for. the 
beginning user. 


When text editing, there is a three way relationship between the 
total text on the disk; the amount of text transferred to main 
memory via an I/0 disk read operation; and the amount of text 
the user is editing within the main memory area which is. called 
the sliding window. 


Assuming you have 32k of memory, the TEXT WINDOW can be from only 

one line of text to encompassing the entire 32k. With the Rt/- 

and W+/- commands (Ref. Sec. 4.1), the user has the ability to 
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vary the size of the window and also slide the window from the 
top of memory to the bottom. For the first-time user, the ability 
to slide the TEXT WINDOW will come with experience. | 


Since the TEXT WINDOW is transparent to the user until you apply 
the Rt/- or Wt/- commands, the first-time user should not be 
overly concerned. 


Ctri-@ - GO TO TOP OF FILE 


This command allows the user to automatically return to the 


beginning of the file (not memory) since some of the other 

commands insist on beginning their operation at the beginning of 

the file. To use this command, insure that you are 7 the TEXT 

SCREEN and not the COMMAND SCREEN. Depress the (CONTROL| 
and|@|keys at the same time. The CURSOR now goes to the begining 
of the file. Disk I/O will occur if necessary to move the TEXT 

WINDOW to the beginning of the file data. 


Ctrl1-B - END OF MEMORY 


The computer memory will only hold X number of bytes of data and 
when used must receive more from the disk. The use of this 
command allows the user to go to the bottom of memory. 


BC,BD,BM - BLOCK MANIPULATION 


These commands) are block manipulating commands that will move 
blocks of text from one area within the file to another area. It 


Should also be noted at each of these commands are used _ in 
conjunction with the |Ctrl-Uj command. 


NOTE: 


1 - Each of the block manipulating commands require two (2) 
block marks - a beginning and an ending mark. 


2 - Additional block marks cannot be entered if any one (1) 
already exist from a previous operation. In order’ to 
perform another operation the previous mark(s) must be 
removed. 


3 - To remove existing block marks, the DEL or DL key must 
be utilized. Eventhough the block marks may be on the 
same line of text. BD automatically removes the block 
marks. 


4 - If the file is a program file, then the entire line 
which contains the marker is in the block ES cercress of 
where the marker is in the line. 
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e BC - BLOCK COPY 


Allows the user to copy a block of text into another area of 
the TEXT WINDOW without deleting the source block of text, 
resulting the same text in two different areas of the TEXT 
WINDOW. | | 


1 - Using the text screen, move the CURSOR to the beginning of 
the text to be copied - depress the |CONTROL! and together. 
You have now set a beginning Block Mark. ; 


2 - Move’ the RSOR to the end of the text to be copied - 
depress |CONTROL}] and[U| together. You have now set the 
ending Block Mark. 


3 - Move the CURSOR to the area of TEXT WINDOW that the block will 


be copied into. 


4 - Depress the |ESC]key to call up the command screen. The 
CURSOR will be flashing by the statement ENTER COMMAND. 
Type in[BC] - depress [RETURN] The marked area has now been 
moved to the new area in TEXT WINDOW. 


e BD - BLOCK DELETE 


1 - Mark the beginning and ending of the text to be deleted. 


2 - On command screen, type in [BD] - Depress [RETURN The text 


has now been deleted. 


e BM - BLOCK MOVE 
Block Move command is performed in the same manner as_~ the 
Block Copy command with the exception that on a Block Move, 
the source text is deleted from the TEXT WINDOW. 


CD,CF,CP - FILE MANIPULATION 


These commands are used to change file names; transfer data from 
one file to another; and to print files. 


@e CD - CHANGE DESTINATION FILE NAME 
This command allows the user to change the name of the 
Destination file (file that the user is presently working 
with). To change your file name, perform the following: 


1 - Bring up the command screen. 











2 - The CURSOR will be flashing by he statement Enter 
Command - type in [CD] and depress |RETURN. 

3 - The CURSOR has now moved to the top of the command 
screen to the statement Destination:. When the CURSOR 
moved, it automatically blanks out the existing file 


name. Type in new Destination File name and depress 
RETURN. 
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This command will move data from any Data File to the 
TEXT WINDOW that you are presently working with and insert the 
data, page (23 lines) at a time starting in the TEXT WINDOW 
designated by the CURSOR. The Data File is selected by the CF 
command and transferred by the USE command. 


The system will go to the Data File and display the first 
source page of the file into the TEXT WINDOW. At the end of 
the display of the first page, the EDITOR will prompt if this 
1s the data desired. If the answer is no, it will continue 
to display source data, one page at a time, allowing the user 
to select the appropriate pages to be transferred to the TEXT 
WINDOW. 


1 - Bring up Command screen. 


2 - Type in [CF] - depress |RETURN 


3 - The CURSOR will move to the statement Data File:. Type 
in the name of the file to transfer data from. Depress 
RETURN. The CURSOR will now move back down to the 
Statement Enter command:. 


4 - Type in the word|USE|(to initiate the display of one 
sequential page of source data) and depress |RETURN. 


5 - At this point, the text screen will be automatically 
displayed and the CURSOR will be flashing at the end of 
the statement TYPE "Y" TO ACCEPT - "N" TO GO ON ~=- ESC 
TO ABORT 


NOTE: 


If there is no file or a blank file, the ESC key must 
be depressed to continue editing. 











CP - TRANSFER DATA TO BE PRINTED 


anew CEES OEE 0 C0 


The CP command, used in conjunction with the S command sends 
data, from a designated Print File, to the printer to be 
printed. : : | 


1 - Bring up the Command screen. 


2 - Type in[CP]- depress [RETURN]. The CURSOR will move up 
the statement Print File:. 


3 - Type in the name of the file to be printed ~- depress 
RETURH, 
4 - Type in{s}- depress |RETURN. The printer will now begin 


its printing or despoo Ing operation. To halt printing, 
depress the [S] key aganin. When re-started, printing 
will continue from the point of the HALT. 


NOTE: 


When the printer starts its printing operation, the 
user can continue the editing process of another file. 


Ctri-D - Rub-out 


TO 


deleted, depress the/Ctrljand the 
will be deleted and the CURSOR wi 


keys together. The character 


delete a character move ne(B] keys to the character to be 
1 move on the character to the 


left without the right most characters being shifted to the left. 


DEL - DELETE A CHARACTER 


The 


DEL key performs the same function as the Ctrl-D function 


extept that when the character is deleted all remaining 
characters to the right of that character will be shifted to the 
left to occupy the deleted character space. 


Ctrl-Y - DELETE A LINE 


To 


delete a line of text move the CURSOR onto the line to be 


deleted. Depress the|Ctrlj and the[Y] together once to arm _ the 
command. Depress the same two keys the second time and the line 
will be eliminated. 


NOTE: 


The DEL LINE key on the ten key pad performs the same 
function with the exception that you only use one Key 
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This command allows the user to display all file names, on the 
display screen, for review. The DIR command works in the same 
manner as the CP/M Operating System DIR command in the sense that 
the user can also call up the directory from any other disk by 
proceeding the DIR X: (replace the "X" with either A,B,C or D). 


DONE - DONE EDITING 


The DONE command is used when the user has completed editing 
files and wishes to save the file. 


Ctri-E - FIND A WORD OR PHRASE 


This command is used in conjunction with the Ctrl-S command to 
search for a word or phrase within the file. The Ctrl-E is used 
to give the word or phrase and the Ctril-S is initiated to search 
for the word or pharse designated. 


NOTE: 
The search command will begin the search starting at the 
CURSOR location to the end of text. In order to search the 
entire text, the CURSOR must be moved to the beginning of 
text via the Ctrl-@ command. It should also be noted that 


the Ctrl-E command may be used from either the COMMAND or 
TEXT screens. | 


1 - Depress the(Ctriljand the[E]keys together. 


2 - Type in the word or phrase to be searched - depress 
RETURN. 
3 - Depress the[Ctri|and the[S|keys together. The CURSOR 


will be flashing on the word or phrase found. 


NOTE: 


To continue searching for the word when it appears 
throughout the text, continue to depress the (Ctri| and 
[s} When no others are found in memory, the system 

will ask if you wish to look on the disk for the word 
or phrase. If yes, the EDITOR will move’ the TEXT 
WINDOW forward through the file until it finds’ the 
search arguement or end of file. 
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ERA fname - ERASE FILE 


Caution should be exercised when using this command!!! When 
initiated, this command will erase the entire file designated. 
The ERA command works in the same manner as the CP/M Operating 
System ERA command. 


1 - Bring up the Command screen. 


2 - Type injERA FILE NAME] - depress |RETURN. 
NOTE: 


The exact name of the file and any extension must 
be given. This editor will not recognize any 
"wild characters" such as the "*" used in CP/M. 


ESC - SWITCH MODES 


The ESC key, located in the top right corner of the keyboard, is 
used to switch from the Command screen to the Text screen and 
vica versa. It is also used with the CF command to get out of a 
no file condition. 


Ctrl-N - INSERT A LINE 


To insert a line of text between existing lines, move the CURSOR 
; e line directly below the line to be inserted. Depress the 
and the[N|keys together. You are now able to add another 
ine of text. To open the text window for more than one line, 
continue to depress the two keys. 


NOTE: 


The INS LINE key on the ten key pad will preform the 
same function. 


Ctri-V - INSERT CHARACTER 


To insert a character, place the CURSOR directly on top of the 
character that the new character will replace. Type in_ the 
character. The CURSOR and the character will move to the left 
with the character it was on and the new character will be placed 
in its vacated spot. 














NOTE: 


The INS MODE key on the edit pad will perform the same 
Function. Beeps will occur when using the INS MODE key 
to get the users attention. 


One Beep = Insert Mode ON 
Two Beeps = Insert Mode OFF 


Ctrl-C - PAGE FORWARD 


This command allows the user to move the CURSOR on page forward 
into the text window. If the current page is not in memory, a 
disk I/0 will be performed moving the text window in a "+" 
direction. 


NOTE: 
The PAGE FWD key on the edit pad will perform the same 
function. 
Ctri-R - PAGE BACKWARD 
This command allows the user to move the CURSOR on page backward 
into the text window. If the current page is not in memory, a 
disk 1/0 will be performed mkoving the text window in a "-" 
direction. 
NOTE: 
The PAGE BKWD key on the edit pad will perform the same 


function. 


QUIT - ABORT EDITING 








This command will abort the editing process and return command of 

the system back to the CP/M Operating System and take it out of 
control of the editor. Caution must be exercised when using this 

command - unlike the DONE command which saves al] text, the QUIT 

command does not save. 


Ctrl-P - REPLACE FUNCTION 


The Ctri-P function is used to replace an existing word with 
another and must be used in conjunction with the Ctrl-E and the 
Ctrl-S commands. 











NOTE: 


The search command will begin the search starting at the 
CURSOR’ location to the end of text. Inorder to search the 
entire text, the CURSOR must be moved to the beginning of 
text via the Ctrl-@ command. 


2 - Depress[Ctriland[E|keys together - an "*" will appear at 


the statement Enter command. 


3 - Type in the existing word followed by a "/" then the 
word that will replace the existing word. Depress 


RETURN) 


4 - Depress the|Ctrijand[S|keys together. The system will 
now go to the Text screen and the CURSOR will be on~ the 


word to be replaced. 


5 - Depress the[Ctri|and[P] together - the existing word will 
now be replaced by the new word. 


NOTE: 


If the user wishes to go completely thru text replacing 
a word, you must start at_the beginning of the text and 
continue to depress the and in sequence. 
The word set by the Ctri-E remains the same once it is 
set. To change the work or phrase, doa Ctrl-E_ to 


being up the word again and just start typing. The old 
word will be replaced with the new word. 


Another option, which works only on the TEXT screen, is 
the Ctrl-G. This command replaces the word with” the 
new word from the point of the CURSOR to the end of 
memory. 


Ctri-Z = DISPLAY PAGE BREAK 


This function is not an automatic feature of the EDITOR. Each 
time the user wishes to see where the page will break when 


printed, you must manually display the dash line, with page 
number, by using the[ CerT=Z]funct on while on the TEXT screen. 
If a page break does not occur in the text currently being 
displayed, no action is taken and you can continue your editing. 
To remove the page break dash line, depress the 

















ON/OFF - PARAGRAPH CHARACTER 


Typing ON will cause the paragraph character to be printed, while 
OFF will cause them to not be printed. Generally only used when 
editing source files. This feature can be set using the DEFAULT 
program | 


R+/- Num - READ FORWARD/BACKWARDS 
Inorder to understand the R+/- function, the user must first 
understand the relationship between main memory (32K bytes of 
data) and the diskette (380K bytes of data). When entering text, 
all of the data goes directly to main memory until it is full. 
At this point, it is then transferred to the diskette and 
continues to transfer in 32k byte segments. | 


Assume you are editing in the middle of your text and wish to 
look at a page of text at the begining of the file. You can use 
the PAGE BKWD key until you have gone completely thru the 
existing 32k of memory a page at a time (one page = 80 columns X 
24 lines of data). When you have exhausted the 32k of memory, 
the operating system will now begin to transfer data at a rate of 
one page of data with each depression of the key. This method 
utilizes read, write, move and display operations which can be 
time consuming. The alternate and faster method is to use the 
R+/- function. 


The Rt/- function acts as a window that can move forward and 
backward thru the text determined by "+" (forward) and the "-" 
(backward). Unlike the PAGE BKWD key, the Rt/- function 
transfers data into main memory in blocks of 32K bytes at a_ time 
not a page at a time. This function can also transfer lines by 
following the R with a number from 1 to 9000 following the "+" or 


NOTE: 


A "+" is always assumed if no sign is given with R. 


Ctrl-S - SEARCH FUNCTION 


This function is used in conjunction with the Ctrl-E function’ to 
search for a particular word or phrase in text. (See Ctri-E 
function). 


S - SPOOL PRINT 








The S function is used in conjunction with the CP function for 
printing. (See CP function). 
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This function takes a portion of an existing file or text and 
transfers it into a newly created file. This function is 
useful when the user has text that may be used in more than one 
file. 


1 - Bring up the Text screen. 


2 - Insert beginning and ending block marks in text to be 
transferred to a new file. (See Ctril-U function). 


3 - Bring up Command screen. 

4 - The CURSOR will be by the statement Enter command. Type 
in [SAVE]followed by a space then type in a file name - 
depress |RETURN. A new file has now been created with 
the text within the block marks. | 


Ctri-T - TOP OF MEMORY 


This function will move the editing operation to the top. of 
memory (do not confuse with Ctrl-@ - top of file function) 
automatically thereby eliminating the use of the PAGE BKWD key. 


T num -TAB SET 

The editor automatically sets the tabs when it is initially 
brought into operation; however the user may use the T-num 
function to change these settings to conform to your. particular 
application. 


1 - Bring up Command screen. 


2 - The CURSOR will be at the statement Enter command - type 
in alT|- depress RETURN. 

3 -Type ina tab setting number - depress |RETURN|. The 
CURSOR will now move to the next tab number - Type _in 
another. To return to Enter command, depress the 
twice. 

4 - The forward and backward arrows may also be used to move 
to another tab number. The user may also change’ the 
last TAB setting without affecting the preceeding 
numbers. 


Ctrl-U - BLOCK MARKER 


The Ctri-U function is used to set beginning and ending block 
markers within text. 
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1 - Bring up the Text screen. | | 
2 - Move the CURSOR to the beginning of the text to be 
marked - depress Ctri-v.| 


3 - Move the CURSOR to the ending of the text ro be marked - 
depress (Ctrl -Uj. 


NOTE: 


Block markers cannot be inserted if two markers already 
exist within the text. Inorder to insert new markers, 
the old ones must be removed. 


USE - USE DATA FILE 

This function is used in conjunction with the CE function. The 
USE function takes text from a previously defined data file and 
inserts it after the line with the CURSOR. It does’ this 
approximately one page at a time, each time asking permission to 
do so. If the user uses ESC, the page is not inserted and the 
user is returned to the command screen. If the USE command is 
again executed the same procedure occurs starting at the place 
where it left off. 


W+/- n - WRITE FORWARD/BACKWARD 


(SEE R+/- N FUNCTION) 


3.0 LOADING THE EDITOR 
With the EDITOR, the user can begin to experiment with entering 
date and printing out messages either on the display screeen or a 
hardcopy printer. 
There are three (3) ways of calling up the DATAMAC EDITOR: 

1 - NO FILE DESIGNATION 

2 - CREATE A NEW FILE 

3 = CALL UP EXISTING FILE 
PROCEDURE: (NO FILE DESIGNATION) 


@e Load the CP/M Operating System 
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Data Mac Screen Editor 52k 


Source : Destination : WORK.TXT Data File: 


Document Print File : 


Space remaining : 31644 
Tabs : 09 17 25 33 41 49 57 65 73 


Characters in use : 3 
Lines in use: l 


Enter command 


MENU 


Ctri-@.....Goto TOF 
Ctri-B.....End of Mem. 
BC,BD,BM...Block Routns 
CD,CF,CP...Change Names 
Ctrl-D.....Rub-out 
DEL......-..Char. Delete 
Ctrl-Y.....Delete Line 
DIR <D:>...Disk Direc. 


DONE.......Done Editing 
Ctri-G.....Global Replac. 
00:51:29 ROW=10 COL=15 


FIGURE 1. 


Ctri-E.....Enter String 
ERA fname..Erase File 
ESC.......eSwitch Modes 
Ctril-N.....Insert Ln. 
Ctrl-V.....Insert Char 
Ctr1-C.....Page Forwrd 
Ctrl-R.....Page Bckwrd 
QUIT.......Abort Edit 
Ctrl-P.....Reple Func 
ON/OFF.....PCHAR Print 


SYSTEM MODE 


R+/- Num...Read Pgrphs 
Ctrl-S.....Search Func 
Sax Spool Print 
SAVE “fine. Write Block 
Ctrl-T.....1op of Mem. 
T num......1lab Set 
Ctrl-U.....Block Marker 
USE s-65s:aG-a%s ~Use Data File 
W+/- num...Write Pgrphs 
Ctr1-Z.....Page Break 


RUN PC= FC3A 


COMMAND SCREEN 
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e When the. 


appears, type in -- depress |RETURN. 


The screen will display the following message: 








e Type in alY|- the system will automatically take over and 
bring up the command screen when completed. (Ref. Fig. 4-1) 


NOTE: 


Reference the Command Screen - by the statement Destination: 
you will see the file name WORK.TXT. This is the file name 

given by the system. To change the file name to one 
tha by the user, initiate the CD command (Ref. 
Sec. 4.1). 


PROCEDURE: (CREATE FILE NAME) 





@e Load CP/M Operating System. 


"appears, type in |DME52K TEST.TXT] -- depress 


e When the 


(RETURW. 


The screen will display the following message: 

















e Type in alY|- the system will automatically take over and 
bring up the Command screen when completed. (Ref. Fig. 4-1) 


NOTE: 


The file name TEST.TXT has automatically been placed by the 
statement Destination: 


PROCEDURE: (EXISTING FILE) 


e Load the CP/M Operating System. 


» appears, type in |DME52K EXIST.TXT| -- depress 





e When the A 


RETURN, 
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The screen will display the following message: 





The file name EXIST.TXT now appears by the = statement 
Destination and the user can begin to edit the text. 


NOTE: 





This procedure may also be used to re-name an existing 
file. It not only re-names the file but creates a new 
file using the existing data from the old file leaving 
the old data and file name intact. This feature is 
advantageous when the user needs to modify the existing 
data for another document and at the same time keeping 
the existing document active. To create the second 
file with a new name, type in the following: 


DME52K OLDFILE NAME.EXT NEW FILENAME.EXT 


4.0 TEXT EDITING MODE 


Now that the editor has been loaded, the user can begin to either 
enter text or edit existing text. To enter text the user’ must 
get from the Command screen to_the Text screen - to accomplish 
this operation, depress pie SSG) key located at the top left 
corner of the keyboard. The Command screen has now been cleared 
and you may begin to enter text. To return to the Command screen 
to perform commands during editing or text entering - depress the 


key again. 


15 

















ein es are an p~ : pee bani! ies ee Se ~ f 


“ F o* - is Tes Lee, oN eis, 2 98 


























